home *** CD-ROM | disk | FTP | other *** search
/ BCI NET / BCI NET Dec 94.iso / archives / programming / libraries / svlib97u.lha / superview-lib_USR / Bonus / JPEG-SVObject / JPEG.doc < prev   
Encoding:
Text File  |  1994-10-29  |  4.7 KB  |  153 lines
  1.  
  2.   JPEG.svobject
  3.  
  4.   © 1994 by Andreas R. Kleinert.
  5.  
  6.   FREEWARE. All rights reserved.
  7.   This software is based in part on the work of the Independent JPEG Group.
  8.  
  9.   Version      : 2.4
  10.   Release Date : 18.09.1994
  11.  
  12.  
  13.   Requirements
  14.   ~~~~~~~~~~~~
  15.   - OS V2.04+ (V37)+ and its libraries
  16.   - 68020+, optimized for 68030
  17.   - superviewsupport.library V3+
  18.  
  19.  
  20.   Description
  21.   ~~~~~~~~~~~
  22.   JPEG.svobject is an external Library-Module for the superview.library V2+.
  23.  
  24.   It contains SVDriver-Support for the superview.library V3+, and
  25.   needs any SVDriver with ChunkyPixel-Support.
  26.  
  27.   It supports reading and writing of JPEG Files as they are written by
  28.   "The Independent JPEG Group's JPEG Software" (release 4).
  29.  
  30.   In detail these are :
  31.  
  32.   Reading :
  33.  
  34.    - JPEG (IJG-JFIF), with output in 256 Colors or 24 Bit
  35.  
  36.   Writing :
  37.  
  38.    - JPEG (IJG-JFIF), from upto 8 or 24 Bit Input
  39.  
  40.  
  41.   Remarks
  42.   ~~~~~~~
  43.   * JPEGTMP:
  44.   * Temporary data will be written to a directory assigned to "JPEGTMP:",
  45.     if neccessary, but please note, that this might affect your HardDisk,
  46.     if this program crashes (e.g. on a corrupt JPEG-picture) !
  47.     So don't blame me, if this happens, but select a _safe_ place for this
  48.     temporary-file directory !
  49.  
  50.   * Functionality :
  51.   * OK, let's get to the more positive things :
  52.     Since the small problems in the first beta version, some bugs in using
  53.     the IJG-Sources have been fixed, and so almost any JPEG (".JPG") pictures
  54.     out there should be read and displayed correctly.
  55.  
  56.   * Writing JPEG-Files :
  57.   * Note, that JPEG-compression is lossy, which means that the original
  58.     picture cannot be reconstructed totally.
  59.     Only JPEG-compress files, of which you have backups, or files which
  60.     you never want to edit and enhance again.
  61.     You should always control the results from saving an JPEG-File : in
  62.     some special cases (e.g. many thin lines on the screen) there may
  63.     occur strong differences to the original picture.
  64.  
  65.  
  66.   ControlPad-Switches
  67.   ~~~~~~~~~~~~~~~~~~~
  68.   ControlPad-Name     : "ENV:superview-library/JPEG.controlpad"
  69.   ControlPad-Commands : - COLORDEPTH = <8/24>
  70.                           ; should the output be done as 8 or 24 Bit Data ?
  71.                           ; default is 8 Bit data
  72.                         - QUANTIZATION = <0..100>
  73.                           ; 0   - no quality, big compression
  74.                           ; 100 - best quality, no compression
  75.                           ; never use these values, but try something
  76.                           ; like 20, 50, 75 (default: 75)
  77.  
  78.  
  79.   Limitations
  80.   ~~~~~~~~~~~
  81.   Please note, that the De/Encoding Routines of the Library are not (yet)
  82.   fully re-entrant, so that only one Task may De/Encode a picture at a time.
  83.   The Library itself manages it, that the other Task has to Delay() until
  84.   the De/Encoding Routines are "free" again.
  85.   This makes NOT REALLY A MATTER, because De/Encoding takes so much of the
  86.   processor's time, that it is NOT EFFICIENT to EN/DECODE TWO OR MORE
  87.   pictures AT THE SAME TIME ANYWAY !
  88.   Nevertheless parallel Decoding while Encoding should be possible without
  89.   problems (if it does not work, please report it to me !).
  90.  
  91.  
  92.   Author
  93.   ~~~~~~
  94.   Andreas R. Kleinert
  95.   Grube Hohe Grethe 23
  96.   D-57074 Siegen
  97.   Germany
  98.  
  99.  
  100.   History
  101.   ~~~~~~~
  102.   V2.4 (18.09.1994) :
  103.  
  104.    - now requesting superviewsupport.library V3+, as needed
  105.      (in docs was V1+, in code it was V2+ instead)
  106.    - startup-code now is definitely 68000 compatible (should have been
  107.      before, also)
  108.    - new ControlPad "QUANTIZATION", which allows to determine the
  109.      ratio between quantity/quality when JPEG-compressing
  110.      (something like a compression factor)
  111.  
  112.  
  113.   V2.3 (08.06.1994) :
  114.  
  115.    - now also writes JPEG-Files.
  116.      Input  : - BIT/ONEPLANE upto 8 Bit
  117.               - ONEPLANE with 24 Bit
  118.      Output : 24 Bit JPEG
  119.    - Note : if you do not need writing of JPEG-Files, you may still use
  120.             the previous versions. They have almost the same functionality,
  121.             but because they are "read-only", they're much shorter ...
  122.  
  123.  
  124.   V2.2 (06.06.1994) :
  125.  
  126.    - removed superviewsupport.library from package, use the version
  127.      supplied with superview.library V6+ instead !
  128.  
  129.  
  130.   V2.1 (21.05.1994) :
  131.  
  132.    - beta-version(s) : V2.0 (nearly all major bugs fixed now)
  133.    - first "public release" version
  134.  
  135.  
  136.   Literature
  137.   ~~~~~~~~~~
  138.   [1] The Independent JPEG Group's software package with Source-Code(s)
  139.       and Documentation.
  140.       (See statement at the top of this Doc-File !)
  141.  
  142.   Credits
  143.   ~~~~~~~
  144.   This software is based in part on the work of the Independent JPEG Group.
  145.   Release 4 of 10-Dec-92 was used (as found on the Walnut Creek "Source
  146.   Code CDROM", March 1994, Directory "MSDOS/GRAPHICS", File "JPEGSRC4.ZIP").
  147.  
  148.  
  149.   Copyrights
  150.   ~~~~~~~~~~
  151.   Some of the mentioned names or products above may be copyrighted by
  152.   companies or trademarks of companies.
  153.